iT邦幫忙

2022 iThome 鐵人賽

DAY 24
0
Software Development

爬蟲基礎入門與實際應用系列 第 24

DAY24、 Discord bot基本架構

  • 分享至 

  • xImage
  •  

本文有整理在部落格裡。
裡面還有其他奇怪的文章,有空可以來看看喔。


昨天介紹了dc的功能還有bot要怎麼申請,今天就可以來講他的基本架構了。


首先先用一個最基本的機器人來示範。請打開一個python檔並鍵入以下內容:

from discord.ext import commands

bot = commands.Bot('%')

@bot.event
async def on_ready():
	print('不客气!')
	print('感谢您使用Discord产品, 欢迎您继续咨询Discord社区!')
	
@bot.command(aliases=['touch'])
async def t(message):
	await message.channel.send('请不要随意地触碰我! 十分感谢!')

if __name__ == "__main__":
	bot.run('在這裡輸入您的token')

接下來分行解釋下。


bot = commands.bot('%')

造出一個bot的物件。而那個'%'就是呼叫機器人的前綴。
不一定要一個字,你要拿'peko'當前綴也是完全可以的。

小補充,如果你也想要用標記機器人來呼叫機器人的話可以這樣寫:

bot = commands.bot(commands.when_mentioned_or('%'))

效果會像這樣:
https://ithelp.ithome.com.tw/upload/images/20221010/20152706nEGgzYWzSc.png

bot裡面詳細有什麼功能可以看一下官方API的文件
看不懂也沒關係,後面會帶到一些常見的用法。


@bot.event

這個@decorator,是python的語法糖。
簡單來說這東西會把下面的函數丟到你@的函數裡面加工,詳細可以看一下這篇
官方API的解釋則在這裡

看不懂也沒什麼關係,就當作一種固定語法。記得在你寫的函數前面加上對應的decorator就行。
像這邊就是因為要使用底下的on_ready()所以才會在上面加@bot.event的,可以看下官方API

另外如果點進去官方API的話可以發現他的例子是加了@client.event
使用discord.clinet是另一種Discord機器人的寫法,client的語法基本上把client代換成bot都可用。
不過bot(discord.ext.commands.Bot)似乎功能比較多一點加上兩者不能混用所以我都用bot寫。
一言以蔽之,看到範例是用clinet就換成bot試試看吧。


async def on_ready():

這邊的asyncawait是python異步執行套件asyncio的語法。

不過這邊難的地方都寫在discord套件底層了,
所以我們只要記得在函數前面加async跟在discord提供的方法前加await就行。

on_ready()這個方法,其功能是在機器人上線的那刻執行下列內容。
所以如果機器人成功運行了可以看到命令列有以下的輸出。
https://ithelp.ithome.com.tw/upload/images/20221009/20152706Sv659LuuVk.png
這樣可以方便我們確定機器人是不是正常上線了。


@bot.command(aliases=['touch'])

@bot.command()這個語法糖可以將下面的函數變成我們在頻道可以使用的指令。
預設指令名稱就是下面的函數名。以這個例子來說就是t

括號中間的aliases=['touch']則是為這個函數添加更多指令名的。
所以結合我們在上面的bot = commands.bot('%')設定的前綴,
機器人上線後我們用%touch%t都可以叫出一樣的指令。


async def t(message):

如上所述,函數名就是你在頻道打的指令名。

括號裡面的message基本上就是你在discord發的訊息。
但他不僅僅是文字,而是discord api一個'Message'類別的物件。

裡面的功能相當的豐富,可以從中取出相當多的資訊,下面會做說明。


await message.channel.send('请不要随意地触碰我! 十分感谢!')

像這邊我們就從中取出了你發送指令的頻道並在那頻道發送了訊息。
具體而言看起來像這樣。
https://ithelp.ithome.com.tw/upload/images/20221009/20152706UMjauH0ZsL.png

其他更多的用法一樣可以詳閱官方API的公開說明書


if __name__ == "__main__":

這行就是確保你是直接執行了這檔案才會跑以下的指令。
bot.run()的括號中間輸入您昨天取得的token碼。


接著就讓機器人上線並邀請你的機器人進自己的伺服器來玩玩吧。
也可以試著改一些設定,或甚至嘗試一些你在官方API找到的功能。
看不太懂上面和官方API到底在講什麼鬼的也沒關係,後面跟著做就會漸漸熟悉了。


上一篇
DAY23、 Discord bot簡介
下一篇
DAY25、 Discord bot基本指令
系列文
爬蟲基礎入門與實際應用30
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言